Oggetti, metodi e proprietà di ActiveX Automation (Windows)
FileMaker Pro supporta tre oggetti Automation: Application, Documents, e Document. I metodi e le proprietà disponibili per gli oggetti sono i seguenti.
Application
Consente di accedere all'applicazione FileMaker Pro.
Proprietà
Nota Tutte le proprietà sono di sola lettura, tranne "Visible"
Application: restituisce un puntatore a questo oggetto, che è l'oggetto principale della gerarchia di oggetti.
Parent: restituisce un puntatore a questo oggetto.
FullName: restituisce il nome dell'applicazione, compreso il percorso.
Name( ): restituisce il nome dell'applicazione - "FileMaker Pro."
Caption: restituisce il titolo della finestra del frame. Il nome di FileMaker Pro è sempre impostato per descrivere il documento correntemente attivo e non può essere impostato in modo diverso dai client.
DefaultFilePath: restituisce il percorso predefinito utilizzato per l'apertura dei file.
Documents: restituisce un puntatore all'oggetto della raccolta Documents, in modo tale che i singoli oggetti Document siano apribili, accessibili e eseguibili mediante script.
Version: restituisce la versione di FileMaker Pro.
Visible: restituisce TRUE se l'applicazione è visibile. Impostare TRUE per visualizzare l'applicazione, FALSE per nasconderla.
ScriptStatus(): restituisce 2 se uno script è in esecuzione, 1 se uno script è in pausa, oppure 0 se non è in esecuzione nessuno script.
Metodi
Quit ( ): chiude l'applicazione. Attenzione: se i client sono ancora allegati, l'applicazione resta nascosta fino a quando tutti i client non rilasciano il server di automazione di FileMaker Pro. Per evitare comportamenti imprevedibili, far sempre seguire un'istruzione di rilascio di oggetto a un'istruzione Quit. Ad esempio:
FMproApp.Quit
Set FMProApp = Nothing
Documents
Si tratta di una raccolta di documenti aperti o di file di FileMaker Pro.
Proprietà
Nota Tutte le proprietà sono di sola lettura.
Application: restituisce un puntatore all'oggetto Application.
Parent: restituisce un puntatore all'oggetto Application.
Count: restituisce il numero di Documents (numero intero lungo) nella raccolta Document.
_NewEnum: restituisce un oggetto enumeratore per passare in rassegna tutti gli oggetti Document nella raccolta Document. Non si tratta di una proprietà esplicita dell'oggetto, ma è implicitamente accessibile quando si utilizza il documento in un ciclo For.
Active: restituisce il documento attivo.
Item(variant): restituisce un oggetto Document specifico dalla raccolta. Questo metodo è il membro predefinito della raccolta Documents. Prende un parametro di variante che può essere specificato da:
 |
Una stringa che rappresenta il nome del file del documento (nome percorso completo). |
|
|
Un indice (numero intero lungo) nella raccolta Document. |
|
|
NULL (che restituisce l'intera raccolta). |
Metodi
Open(filename As String, accountName As String, password As String): apre un file di FileMaker Pro specifico, crea un oggetto Document e restituisce un puntatore all'oggetto Document.
Close( ): chiude tutti i documenti nella raccolta e li rimuove da questa raccolta. L'istruzione Document Close determina una chiusura forzata del documento. Se altri utenti sono collegati al database di FileMaker Pro quando l'applicazione riceve un'istruzione Document Close, verranno scollegati immediatamente e senza preavviso. Prima di inviare questo comando, è opportuno fornire agli utenti collegati la possibilità di uscire da FileMaker Pro.
Documento
Un "Document" è un file di database di FileMaker Pro.
Proprietà
Nota Tutte le proprietà sono di sola lettura.
Application: restituisce un puntatore all'oggetto Application.
Parent: restituisce un puntatore all'oggetto Document Collection, l'oggetto padre dell'oggetto Document.
FullName: restituisce la specifica del file del documento, incluso il percorso. Se il comando Document FullName viene inviato a un file remoto in esecuzione su un host, verrà restituito solo il nome del file e non il relativo percorso.
Path: restituisce la specifica del percorso del documento. Questo non include né il nome del file né l'estensione.
Saved: restituisce lo stato del documento (indica se il documento è stato salvato o meno). FileMaker Pro restituisce sempre TRUE.
Active: se la finestra dell'oggetto Document è attiva, viene riportato TRUE, in caso contrario FALSE.
Metodi
Activate( ): rende attiva la finestra associata a questo oggetto Document.
Save( ): scarica la cache del database.
Close( ): chiude il documento e lo rimuove dalla raccolta Documents.
DoFMScript(WhichScript As String): esegue uno script di FileMaker Pro su questo oggetto Document. Lo script viene specificato per nome e deve già essere presente in Document (ad esempio nel file di FileMaker Pro).
Argomenti correlati
 |
|